home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus Extra 1997 #1 / Amiga Plus Extra 1997 #1.iso / programme / tools / mmkeyboard / mmkeyboard.dok < prev    next >
Text File  |  1996-06-01  |  17KB  |  468 lines
  1. Document MMKeyboard V0.8
  2.  
  3.  
  4.                       Multimedia-Keyboard V1.3
  5.                       ~~~~~~~~~~~~~~~~~~~~~~~~
  6.  
  7.                     Programm und Design (W) 1996
  8.                           Jürgen Reinert
  9.  
  10.  
  11.  
  12.  
  13.  
  14. 0. Produktinfo
  15.    -----------
  16.  
  17.  
  18.         Projektname ....... MMKeyboard
  19.         
  20.         Version ........... 1.3
  21.         
  22.         Autor ............. J.Reinert
  23.         
  24.         Programmiersprache. Blitz Basic 2
  25.         
  26.  
  27.  
  28.  
  29.  MMKeyboard ist Freeware und darf uneingeschränkt kopiert und genutzt
  30.  werden, solange das ganze MMKeyboard-Paket unverändert bleibt. FÜr
  31.  Schäden, die durch benutzen dieses Programmes und der vorgestellten
  32.  Hardware entstehen, übernimmt der Autor keine Haftung. MMKeyboard
  33.  ist auf Amiga 4000/040 und A2000 getestet und für lauffähig erklärt
  34.  worden.
  35.  
  36.  Wenn Sie MMKeyboard gewerblich nutzen sollten, bitte ich um eine kleine
  37.  Mitteilung diesbezüglich (zum angeben bei Freunden :)  ). Auch sonst
  38.  würde ich mich über Mitteilungen freuen, die mir den Einsatz meines
  39.  Programmes beschreiben.
  40.  
  41.  
  42.  
  43.  "MMKeyboard" schließt die Lücke zwischen "präsentieren" und "Tastatur
  44.  verstecken". Anstelle der Computer-Tastatur findet ein kleines Tasten-
  45.  feld mit 12 Tasten Verwendung. Eventuell findet man ja in der Bastel-
  46.  kiste noch eine geeignete Tastatur. Die Tastatur muss aus 3 Spalten
  47.  mit je 4 Tasten bestehen und darf keine Elektronik enthalten. Die
  48.  Tasten müssen als Matrix verdrahtet sein und sollten nicht allzu
  49.  stark prellen. Programme, die normalerweise über das "input.device"
  50.  ihre Eingaben erhalten, sollten auch mit MMKeyboard funktionieren.
  51.  MMKeyboard ersetzt je nach Einstellung:
  52.  
  53.         - die Tasten 0 bis 9, "*" und <Enter> auf dem Ziffernblock
  54.         
  55.         - die Funktionstasten 1 bis 10, Enter und Return
  56.  
  57.  Präsentationen und Infodienste, die mit Ziffern- oder Funktionstasten
  58.  gesteuert werden können, sollten auch mit MMKeyboard zurechtkommen.
  59.  Näheres zur Tastatur finden Sie im `Anhang'.
  60.  
  61.  
  62.  
  63. 2. Systemvoraussetzungen
  64.    ---------------------
  65.  
  66.  
  67.   - Auf jeden Fall einen Amiga  ;-)
  68.  
  69.   - 1MB RAM (auf 512K-Maschinen nicht getestet;sollte aber laufen)
  70.  
  71.   - Amiga-OS 2.04 oder besser
  72.  
  73.   - Kleine Tastatur 3x4 mit offener Matrix
  74.  
  75.   - Freien Parallelport (Amiga oder MultifaceCard2)
  76.  
  77.  
  78.  
  79. 4. Installation
  80.    ------------
  81.  
  82.  MMKeyboard besteht nur aus einem Programm. Es benötigt nur die üblichen-
  83.  System-Librarys und Resourcen, die in einem installierten System ohnehin
  84.  vorhanden sind. Das Programm kann samt Piktogramm mit der Maus gegriffen
  85.  und in das Verzeichnis verschoben werden, wo es benötigt wird. Für auto-
  86.  matischen start ist der Ordner "WBStartup" auf der Workbench-Partition/
  87.  bzw -Disk geeignet.
  88.  
  89.  Achtung: MMKeyboard ist ein Commoditie OHNE Eingabefenster. Das Programm
  90.           lässt sich nur mit hilfe des Programmes "Exchange" beenden und
  91.           aus dem Speicher entfernen.
  92.           
  93.  Beachten Sie bitte, daß MMKeyboard immer nur eine Taste registriert. Auch
  94.  wenn mehrere Tasten gleichzeitig betätigt werden.
  95.  
  96.  
  97.  
  98.  
  99. 5. Starten von Workbench
  100.    ---------------------
  101.  
  102.  Achtung: stellen Sie sicher, daß Sie eine Workbench größer oder gleich
  103.           2.04 installiert haben. MMKeyboard prüft die Version nicht und
  104.           verlässt sich darauf, daß Sie darauf achten !
  105.  
  106.  
  107.  MMKeyboard wird einfach per Doppelklick auf das Piktogramm gestartet.
  108.  Je nachdem, wo Sie die Zusatztastatur angeschlossen haben, müssen Sie
  109.  den verwendeten Port noch einstellen. Dies wird über Merkmale (Tooltypes)
  110.  gemacht.
  111.  
  112.  Aktivieren Sie das Programm-Icon durch einfachen Klick mit der Maus und
  113.  rufen Sie im Workbenchmenü den Punkt "Piktogramm/Information" (bzw "Icon/
  114.  Information") auf. Daraufhin öffnet sich ein Fenster mit Informationen.
  115.  
  116.  Normalerweise sind im Fenster "Merkmale" ("Tooltypes") bereits alle wich-
  117.  tigen Einträge vorhanden. Nicht verwendete Einträge sind eingeklammert
  118.  und beeinflussen das Programm nicht. Zum ändern eines Eintrages klicken
  119.  Sie auf die zu ändernde Zeile und anschließend in das darunter liegende
  120.  Eingabefeld. Schreiben Sie Ihre Änderungen und beenden Sie die Eingabe
  121.  mit der Return-Taste. Im Merkmale-Fenster erscheint jetzt der geänderte
  122.  Text. verlassen Sie das Fenster mit Klick auf "Speichern" ("Save") und
  123.  starten Sie dann "MMKeyboard"
  124.  
  125.  Um neue Merkmale einzufügen betätigen Sie im Informations-Fenster den
  126.  Schalter "Neu" ("New") und schreiben dann die Zeile. Alle Merkmale, die
  127.  Sie verwenden können, finden Sie unter `Parameter'
  128.  
  129.  Beendet wird MMKeyboard mit hilfe des Programmes "Exchange" der Workbench.
  130.  
  131.  
  132.  
  133. 6. Starten von Shell
  134.    -----------------
  135.  
  136.  Achtung: stellen Sie sicher, daß Sie eine Workbench größer oder gleich
  137.           2.04 installiert haben. MMKeyboard prüft die Version nicht und
  138.           verlässt sich darauf, daß Sie darauf achten !
  139.  
  140.  
  141.  Die Befehlsschablone für MMKeyboard erhalten Sie, wenn Sie den Programm-
  142.  name mit einem Fragezeichen in einer Shell bzw CLI eingeben:
  143.  
  144.         MMKeyboard ?
  145.  
  146.  Dies funktioniert aber nur, wenn MMKeyboard sich im aktuellen Verzeich-
  147.  nis bzw. in einem Verzeichnis mit angelegtem Suchpfad befindet. Gefunden
  148.  wird MMKeyboard normalerweise in den Verzeichnissen "SYS:C", "SYS:Tools",
  149.  "SYS:Utilities" und auch "SYS:WBStartup" (SYS=Workbench-Disk/Partition).
  150.  
  151.  
  152.  Hier die Schablone:
  153.  
  154.    MFC=MFCNUM/K/N,FUNCKEYS/S,
  155.  
  156.  Genaueres zu diesen Schlüsselwörtern finden Sie unter `Parameter'.
  157.  Beachten Sie bitte, daß beim Start vom CLI nur zwei Parameter
  158.  ausgewertet werden. Vollen Zugriff auf alle Einstellmöglichkeiten
  159.  haben Sie nur beim Workbench-Start.
  160.  
  161.  
  162.  "MMKeyboard MFC=0"     startet das Programm auf einer MultifaceCard
  163.                         Port 0.
  164.  
  165.  "MMKeyboard FUNCKEYS"  startet das Programm auf dem Amiga-Parallelport.
  166.                         Anstelle der Zifferntasten werden aber die
  167.                         Funktionstatsten emuliert.
  168.  
  169.  
  170.  MFC muß nummerisch (also Zahlen) sein. Auf Groß- Kleinschreibung wird
  171.  hier nicht geachtet.
  172.  
  173.  Beendet wird MMKeyboard mit hilfe des Programmes "Exchange" der Workbench.
  174.  
  175.  
  176.  
  177. 7. Parameter
  178.    ---------
  179.  
  180.  Folgende Merkmale werden ausgewertet:
  181.  
  182.     DONOTWAIT   Dies ist ein "Schalter" und wird von der Workbench
  183.                 ausgewertet. Wenn MMKeyboard aus dem WBStartup-Ordner
  184.                 gestartet werden soll, muß dieses Merkmal unbedingt
  185.                 eingetragen sein. Es schadet aber auch nicht bei
  186.                 manuellem Start. Bei CLI-Start hat dieser Parameter
  187.                 keine Wirkung
  188.  
  189.  
  190.     MFC         Wenn Sie eine MultifaceCard installiert haben und die
  191.                 kleine Tastatur an einem der paralleln Ports der MFC
  192.                 angeschlossen haben, müssen Sie mit diesem Merkmal
  193.                 dem Programm den verwendeten Port mitteilen. Mit dem
  194.                 Eintrag "MFC=0" wird der erste Parallelport der Multi-
  195.                 faceCard abgefragt. Bei "MFC=1" wird der zweite Port
  196.                 verwendet. Bei mehreren MultifaceCards kann der Ein-
  197.                 trag auch "MFC=3" bzw "MFC=4" lauten. Bei zwei in-
  198.                 stallierten MultifaceCard 2 wird mit "MFC=3" der erste
  199.                 ParPort der zweiten Karte benutzt:
  200.  
  201.                 MFC=        Karte-Nr        Port-Nr
  202.                 -----------------------------------
  203.                  0              0              0
  204.                  1              0              1
  205.                  2              1              0
  206.                  3              1              1
  207.                  4              2              0
  208.                  5              2              1
  209.                  6              3              0
  210.  
  211.                 Fehlt dieser Parameter oder ist keine MultifaceCard
  212.                 installiert, wird automatisch der Parallelport des
  213.                 Amiga verwendet
  214.  
  215.  
  216.     FUNCKEYS    Normalerweise werden von MMKeyboard die Zifferntasten
  217.                 des Abgesetzten Tastenblocks emuliert. Wenn Sie im
  218.                 Programm-Icon das Merkmal "FUNCKEYS" einsetzen, werden
  219.                 statt dessen die Funktionstasten 1 bis 10 sowie die
  220.                 Tasten <Enter> und <RETURN> emuliert.
  221.  
  222.  
  223.     CODESET     Mit diesem Merkmal kann die Tastaturbelegung komplett
  224.                 oder teilweise geändert werden. Als Grundlage dient
  225.                 die normale Einstellung bzw. die Funktionstasten-Tabelle,
  226.                 wenn das Merkmal FUNCKEYS gesetzt ist. Die bei "CODESET"
  227.                 angegebenen Tasten-Codes werden der Reihe nach auf die
  228.                 Tasten 1,2,3,4...# gelegt. Die Tasten-Codes müssen in 
  229.                 der Form ASCII-HEX eingegeben werden. Dabei müssen pro
  230.                 Taste immer 2 Zeichen angegeben werden. Die einzelnen
  231.                 Parameter dürfen nicht durch Leerzeichen o.ä. getrennt
  232.                 werden.
  233.  
  234.                 Beispiel:   CODESET=203533      Belegt die Tasten 1,2,3
  235.                                                 mit den Zeichen a,b und c
  236.  
  237.                 Welche HEX-Zahlen Sie für welche Taste angeben müssen,
  238.                 erfahren Sie im Abschnitt `Tastencodes'.
  239.  
  240.  
  241.  
  242.     1 2 3 4 5   Die nächsten Merkmale alle einzeln aufzuführen wäre dumm,
  243.     6 7 8 9 *   da sie alle eine ähnliche Funktion haben. Da Sie die
  244.     0 #         Tastenbelegung mit den Merkmal "FUNCKEYS" und "CODESET"
  245.                 nur eingeschränkt beeinflussen konnten, gebe ich Ihnen
  246.                 mit diesen Merkmalen vollen Zugriff auf jede einzelne
  247.                 Taste. Jedes Zeichen der linken Seite repräsentiert eine
  248.                 Taste auf Ihrer kleinen Tastatur am Druckerport. Durch
  249.                 eine einfache Zuweisung eines neuen HEX-Codes für eine
  250.                 dieser Tasten können Sie gezielt jede einzelne Taste ver-
  251.                 ändern.
  252.  
  253.                 Beispiel:   1=20    Belegt Taste "1" mit Zeichen "a"
  254.                             *=45    Belegt Taste "*" mit ESC
  255.  
  256.                 Grundlage ist entweder die normale Ziffernfolge, die
  257.                 Funktionstasten (wenn Merkmal "FUNCKEYS" gesetzt) oder
  258.                 Ihre eigene Belegung, die Sie mit "CODESET" gegeben haben.
  259.  
  260.                 Welche HEX-Zahlen Sie für welche Taste angeben müssen,
  261.                 erfahren Sie im Abschnitt `Tastencodes'.
  262.  
  263.  
  264.  
  265.  
  266. 8. Tastencodes
  267.    -----------
  268.  In diesem Abschnitt führe ich alle Tasten der Amiga-Tastatur auf, die
  269.  Sie mit MMKeyboard emulieren können. Es handelt sich dabei um soge-
  270.  nannte RAW-Codes. Dies sind Codes, die für jede Taste nur einmal exis-
  271.  tieren. Obwohl auch Sondertasten wie Shift, Ctrl usw. emuliert werden
  272.  können, ist es z.Z. nicht möglich, Großbuchstaben oder andere Zeichen
  273.  zu emulieren, die zwei Tasten gleichzeitig erfordern.
  274.  
  275.  
  276.  
  277.  Taste  HEX-Code        Taste   HEX-Code        Taste   HEX-Code
  278.  
  279.   ESC      45           L-Shift    60             k        27
  280.   F1       50           L-Alt      64             l        28
  281.   F2       51           L-Amiga    66             ö        29
  282.   F3       52           R-Amiga    67             ä        2A
  283.   F4       53           R-Alt      65             #        2B
  284.   F5       54           R-Shift    61             <        30
  285.   F6       55           Return     44             y        31
  286.   F7       56           Curs-Up    4C             x        32
  287.   F8       57           Curs-Dwn   4D             c        33
  288.   F9       58           Curs-Lef   4F             v        34
  289.   F10      59           Curs-Rig   4E             b        35
  290.   `        00             q        10             n        36
  291.   1        01             w        11             m        37
  292.   2        02             e        12             ,        38
  293.   3        03             r        13             .        39
  294.   4        04             t        14             -        3A
  295.   5        05             z        15           Pad [      5A
  296.   6        06             u        16           Pad ]      5B
  297.   7        07             i        17           Pad /      5C
  298.   8        08             o        18           Pad *      5D
  299.   9        09             p        19           Pad 7      3D
  300.   0        0A             ü        1A           Pad 8      3E
  301.   ß        0B             +        1B           Pad 9      3F
  302.  Apost.    0C             a        20           Pad -      4A
  303.  Backsl.   0D             s        21           Pad 4      2D
  304.  Backs.    41             d        22           Pad 5      2E
  305.   Del      46             f        23           Pad 6      2F
  306.  Help      5F             g        24           Pad +      5E
  307.  Tab       42             h        25           Pad 1      1D
  308.  Ctrl      63             j        26           Pad 2      1E
  309.  Pad 3     1F           Pad Enter  43           Pad 0      0F
  310.  Pad .     3C           Space      40
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317. 9. Kontaktadresse
  318.    --------------
  319.  
  320.  Damit mich das "Feedback" auch erreichen kann, gebe ich hier meine
  321.  Kontaktmöglichkeiten bekannt. Persönliche Besuche bitte vorher mit
  322.  mir absprechen. Briefe, Geschenke und sonstige Dinge dürfen direkt
  323.  an die angegebene Adresse geschickt werden. Wenn jemand eine Antwort
  324.  erwartet (Brief), so sollte auf jeden Fall ein frankierter Rückum-
  325.  schlag beigelegt werden.
  326.  
  327.  
  328.  Adresse :  Jürgen Reinert
  329.             Am Kirchberg 4
  330.             31275 Lehrte
  331.  
  332.  Telefon :  05175-3972
  333.  
  334.  BTX-Mail:  051753972-0001
  335.  
  336.  oder über den Amiga-Club im BTX (AC) A-Seite "Techno"
  337.  
  338.  
  339.  
  340.  
  341.  Ansonsten wünsche ich frohes gelingen mit meinem kleinen Programm. Ich
  342.  habe während der Programmierphase jedenfalls meinen Spaß gehabt. Man
  343.  sollte nicht glauben, was so alles schief gehen kann :)
  344.  
  345.  
  346.  
  347.  
  348. 8. Anhang
  349.    ------
  350.  Jetzt geht es an die Hardware. Die Tastatur kann fertig gekauft oder auch
  351.  selber gebaut werden. Außer den Tasten wird noch ein geeignetes Kabel mit
  352.  sieben Adern, eine Sub-D-Stiftleiste 25polig und eine passende Griffkappe
  353.  benötigt. Bei vorsichtiger Handhabung kann ein Flachbandkabel bei wegfall
  354.  der Griffkappe verwendet werden. In der Regel eignet sich Telefonkabel
  355.  (8-adrig) sehr gut. Achten Sie darauf, daß das Kabel nicht zu lang wird.
  356.  Während der Programmierzeit verwendete ich ein Kabel mit 3 Meter Länge.
  357.  
  358.  Alle benötigten Teile sind im Elektronikhandel (auch Conrad-Electronic)
  359.  erhältlich.
  360.  
  361.  Und so wird die Tastaturmatrix am ParPort angeschlossen. Da ich die An-
  362.  schlussbelegung Ihrer Tastatur nicht kenne (ich fand bei mir eine Tasta-
  363.  tur in der Bastelkiste), müssen Sie sich diese ausmessen. Dies ist aber
  364.  relativ einfach zu machen. Jeder Schalter in der Matrix verbindet je
  365.  eine senkrechte und eine waagerechte Leitung am Kreuzpunkt miteinander.
  366.  Wenn z.B. die Taste "7" betätigt wird, muss diese Taste einen Kurzschluss
  367.  zwischen den Leitungen D0 und D6 machen. Bei Taste "6" würden die Lei-
  368.  tungen D2 und D5 kurzgeschlossen.
  369.  
  370.  Alle nicht benötigten Tasten können ersatzlos entfallen und beeinträch-
  371.  tigen die Funktion nicht. Auch die nicht benötigten Verbindungsleitungen
  372.  können entfallen.
  373.  
  374.  
  375.  
  376.  
  377.     Vollständige Tastatur
  378.     ---------------------
  379.  
  380.  
  381.                    Datenbit  Sub-D Stecker   Meine Tastatur
  382.                    --------  -------------   --------------
  383.  
  384.        +------------- D0 ------ Pin 2            Pin 5
  385.        |
  386.        |
  387.        |
  388.        |   +--------- D1 ------ Pin 3            Pin 6
  389.        |   |
  390.        |   |
  391.        |   |
  392.        |   |   +----- D2 ------ Pin 4            Pin 7
  393.        |   |   |
  394.        |   |   |
  395.       +-+ +-+ +-+
  396.       |1|-|2|-|3|---- D4 ------ Pin 6            Pin 1
  397.       +-+ +-+ +-+
  398.        |   |   |
  399.       +-+ +-+ +-+
  400.       |4|-|5|-|6|---- D5 ------ Pin 7            Pin 2
  401.       +-+ +-+ +-+
  402.        |   |   |
  403.       +-+ +-+ +-+
  404.       |7|-|8|-|9|---- D6 ------ Pin 8            Pin 3
  405.       +-+ +-+ +-+
  406.        |   |   |
  407.       +-+ +-+ +-+
  408.       |*|-|0|-|#|---- D7 ------ Pin 9            Pin 4
  409.       +-+ +-+ +-+
  410.  
  411.  
  412.  
  413.  Wenn Sie anstelle der Ziffern lieber die Funktionstasten emulieren möchten
  414.  (siehe `Parameter'), ändert sich nur die Belegung der Tasten. Die Schal-
  415.  tung ist die selbe. Folgende Veränderungen ergeben sich:
  416.  
  417.     Taste 1 = Funktionstaste  1
  418.     Taste 2 = Funktionstaste  2
  419.     Taste 3 = Funktionstaste  3
  420.     Taste 4 = Funktionstaste  4
  421.     Taste 5 = Funktionstaste  5
  422.     Taste 6 = Funktionstaste  6
  423.     Taste 7 = Funktionstaste  7
  424.     Taste 8 = Funktionstaste  8
  425.     Taste 9 = Funktionstaste  9
  426.     Taste * = Funktionstaste 10
  427.     Taste 0 = Return-Taste
  428.     Taste # = Enter-Taste
  429.  
  430.  
  431.  
  432.  
  433.  
  434.     Abgespeckte Tastatur für die Funktionstasten 1 und 2
  435.     ----------------------------------------------------
  436.  
  437.  
  438.  
  439.  
  440.                    Datenbit  Sub-D Stecker
  441.                    --------  -------------
  442.  
  443.        +------------- D0 ------ Pin 2
  444.        |
  445.        |
  446.        |
  447.        |   +--------- D1 ------ Pin 3
  448.        |   |
  449.        |   |
  450.        O   O
  451.       \   \   <-- Dies sollen zwei Schalter sein (Schließer)
  452.        \   \
  453.        O   O
  454.        |   |
  455.        +---*--------- D4 ------ Pin 6
  456.             \
  457.              \_An dieser Stelle muss eine leitfähige
  458.                Verbindung bestehen !
  459.  
  460.  
  461.     Im Programm-Icon müssen Sie das Merkmal (ToolType) "FUNCKEYS"
  462.     eingetragen haben und MMKeyboard per Doppelklick starten.
  463.     Falls MMKeyboard noch laufen sollte, müssen Sie es zuerst be-
  464.     enden bevor Sie es mit neuen Merkmalen starten.
  465.  
  466.  
  467.  
  468.